home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 February / OpenLinux 2.3 CD.iso / UPDATEus.txt < prev   
Encoding:
Text File  |  1999-08-12  |  5.0 KB  |  130 lines

  1. --------------------------------------------------------------------------------
  2. EXECUTING THE OPENLINUX 2.3.000.0 UPDATE SCRIPT                 August 1999
  3.  
  4. This section explains how to execute the OpenLinux 2.3.000.0 update script.
  5. Before you execute the update script, you should read this entire document.
  6.  
  7. This document includes the following information:
  8.  
  9. - A word about the new version number scheme
  10. - Obtaining the latest update script
  11. - New features in the update script
  12. - Executing the update script
  13.  
  14.  
  15. A WORD ABOUT THE NEW VERSION NUMBER SCHEME
  16. ==========================================
  17. You may have noticed that some version numbers have changed with this release of
  18. the update.col script. The new update script is called "2.3.000.0"
  19.  
  20. Here's a description of each field in the version number (for example,
  21. "update.col-2.3.000.0"):
  22.  
  23. - The First Number field indicates the major release.
  24.  
  25. - The Second Number field indicates the minor release.
  26.  
  27. - The Third Number field indicates the maintenance release.
  28.  
  29. - The Fourth Number indicates the iteration version of the script.
  30.  
  31. NOTE: To determine the version of a certain "update.col" script, enter
  32. "./update.col --version".
  33.  
  34.  
  35. OBTAINING THE LATEST UPDATE SCRIPT
  36. ==================================
  37. To obtain the latest version of the update script, visit Caldera's FTP site at
  38. ftp://ftp.calderasystems.com/pub/openlinux/updates/.
  39.  
  40.  
  41. NEW FEATURES IN THE UPDATE SCRIPT
  42. =================================
  43. This update.col utility supports updating from COL2.2 to newer OpenLinux
  44. release levels.
  45.  
  46. Examples of updates:
  47.  
  48.         OpenLinux-2.2-7 => OpenLinux-2.2-8
  49.         ...
  50.  
  51. An update engine embedded within the script dynamically builds a script for
  52. your machine based on your update path.
  53.  
  54.  
  55. EXECUTING THE UPDATE SCRIPT
  56. ===========================
  57. WARNING! Please follow these steps exactly.
  58.  
  59.  1. Back up your existing system. It is always a good idea to back up your
  60.     system before updating software, especially when the update.col script is a
  61.     complex procedure.
  62.  
  63.  2. Log in locally as the root user.
  64.  
  65.     NOTE: To avoid problems with rebooting, don't log in as the superuser (su)
  66.     or as the root user over a network.
  67.  
  68.  3. Insert the OpenLinux CD you are updating to.
  69.  
  70.  4. Mount the CD-ROM (for example, enter "mount /mnt/cdrom").
  71.  
  72.     All packages must reside in /mnt/cdrom/Packages/RPMS. In the case of a
  73.     security update distributed on diskette (as with OpenLinux Standard 1.1),
  74.     /mnt/floppy/security/RPMS is included in the package path and may be used if
  75.     the diskette has been mounted with the "mount /mnt/floppy" command.
  76.  
  77.     If update packages reside in directories other than what was specified above
  78.     on the CD-ROM or diskette, see the usage notes by entering
  79.     "/sbin/update.col --help".
  80.  
  81.  5. Copy the "update-2.3.000.0.tgz" file to the root directory (/) of your
  82.     filesystem (not "/root").
  83.  
  84.  6. To extract the contents of the archive:
  85.  
  86.     a. Access the root (/) directory (for example, enter "cd /").
  87.  
  88.     b. Enter "tar zxvf update-2.3.000.0.tgz", where "2.3.000.0" is the
  89.        current update script. The "update.col" script is added to the /sbin
  90.        directory.  Do not move the script! The script MUST reside in the root
  91.        filesystem partition for the update to function properly.
  92.  
  93.  7. Have all users log off the system you're updating, then change to runlevel 1
  94.     by entering "/sbin/telinit 1".
  95.  
  96.  8. To show the steps that will occur when you execute the script:
  97.  
  98.     a. Enter "/sbin/update.col --test". The "update.script" file is added to the
  99.        "/tmp/update.$PID" directory, where "$PID" is the process ID number under
  100.        which the test was run.
  101.  
  102.     b. Verify the "update.script" file in the "/tmp/update.$PID" directory,
  103.        where "$PID" is the process ID number under which the test was run. Note
  104.        any  problems that may conflict with your system's current configuration,
  105.        such as modifications to packages shipped by Caldera.
  106.  
  107.        NOTE: The update script should not replace any custom updates you made.
  108.  
  109.  9. To execute the update script, enter "/sbin/update.col".
  110.  
  111.     Log files will be kept of what was done. The log files appear in the
  112.     "/tmp/update.$PID" directory, where "$PID" is the process ID number under
  113.     which the test was run.
  114.  
  115.     If the system detected the update, you are prompted to reboot the system.
  116.  
  117. 10. If you're asked if you want to reboot the system, enter "yes". If you're
  118.     not prompted to reboot the system, enter "/sbin/reboot" or enter
  119.     "/sbin/reboot -f".
  120.  
  121.     If any e2fsck filesystem errors appear after the system reboots, disregard
  122.     them. These errors are caused by temporary files and the filesystem
  123.     automatically repairs them.
  124.  
  125. 11. Check the log file.
  126.  
  127.     If you encounter problems with this update, check the "update.log" file in
  128.     the "/tmp/update.$PID/update.log" directory, where "$PID" is the process ID
  129.     number under which the script was run.
  130.